home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / chgenv.zip / CHGENV.TXT < prev    next >
Text File  |  1990-03-12  |  7KB  |  199 lines

  1.  
  2.  
  3.  
  4.                                    CHGENV.EXE
  5.                             A DOS ENVIRONMENT EDITOR
  6.  
  7.                                        BY
  8.                                  PETER A. HYMAN
  9.                                  (609) 799- 2638
  10.  
  11.  
  12.      DESCRIPTION:
  13.  
  14.      CHGENV (Change Environment) is a program designed to allow the user  to
  15.      easily change settings in the Environment.   With CHGENV,  the user may
  16.      add to, delete from or modify any of the SETtings currently in effect.
  17.      CHGENV  is particularly useful when a long environment  variable  (e.g.
  18.      PATH) requires modification.   The user need not retype the entire  SET
  19.      command with CHGENV, merely edit the setting.
  20.  
  21.      USAGE:
  22.  
  23.      CHGENV has no command line arguments, simply type CHGENV [ENTER].
  24.  
  25.      CHGENV displays a copyright message followed by the location in  memory
  26.      of  the MASTER copy of the Environment,  its Maximum  allowable  length
  27.      followed  by the current length of all the environment strings in  use. 
  28.      The Maximum length may not be exceeded.
  29.  
  30.      Next,  CHGENV will display all currently SET environment  variables  in
  31.      ALPHABETICAL order.   If more than 16 variables are set,  a scroll  bar
  32.      will be displayed in the left margin.
  33.  
  34.      There are only three operations which CHGENV performs,  and three  keys
  35.      used to perform them:
  36.  
  37.      INSERT KEY:    Add a New Environment Variable
  38.      DELETE KEY:    Delete Currently Selected Environment Variable
  39.      ALT-C KEY:     Change Currently Selected Environment Variable
  40.  
  41.      Pressing Control-Break,  Control-C or ESCAPE immediately ends the  pro-
  42.      gram.  Pressing F10 ends the session prompting the user if he wishes to
  43.      save the changes.  Even if no edits have been made, the environment has
  44.      been sorted and the Save Changes prompt will always appear.
  45.  
  46.      A highlighter is always visible.   It indicates the  currently-selected
  47.      Environment Variable.   To move the highlighter, the UP or DOWN Cursor,
  48.      HOME or END or RETURN Keys may be used to move about the screen.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                    CHGENV.EXE
  71.                             A DOS ENVIRONMENT EDITOR
  72.  
  73.                                        BY
  74.                                  PETER A. HYMAN
  75.                                  (609) 799- 2638
  76.  
  77.  
  78.      ADDING A NEW ENVIRONMENT VARIABLE:
  79.  
  80.      All Environment Variables may be a maximum of 128 characters or the re-
  81.      maining  available environment space,  whichever is less.   The  syntax
  82.      must be:
  83.  
  84.      name=value
  85.  
  86.      where name is the name of the Environment Variable (e.g.  PROMPT),  the
  87.      equal  sign  is mandatory with or without a space in between,  and  the
  88.      value is the text or numeric value to be associated with the  Variable. 
  89.      CHGENV will display a line near the bottom of the screen when INSERT is
  90.      pressed and prompt Add: , followed by a highlighted area.  If the Envi-
  91.      ronment  Variable is more than the screen width,  the  characters  will
  92.      scroll  until done.   Any edit may be completed by pressing the  UP  or
  93.      DOWN cursor,  HOME or END keys or RETURN.   If the Environment Variable
  94.      to  be  added does not contain an equal sign,  or if its  length  would
  95.      cause  the  total Environment Length to exceed its maximum,  and  error
  96.      will be reported.
  97.  
  98.      If  the Environment Variable to be added is the same as one already  in
  99.      the Environment,  it will replace the existing one (although the CHANGE
  100.      option could also be used to edit the existing Environment Variable).
  101.  
  102.      Once editing is completed, the newly-added Environment Variable will be
  103.      sorted into the display.
  104.  
  105.      DELETING AN ENVIRONMENT VARIABLE:
  106.  
  107.      The currently highlighted Environment Variable may be deleted by press-
  108.      ing the DELETE Key.  When this is done, the variable to be deleted will
  109.      flash and a prompt Delete This Environment String?  will be  displayed. 
  110.      A 'Y' or 'N' in upper or lower case must be entered in response to this
  111.      prompt.   If 'Y'  is entered, the Environment String is deleted and the
  112.      list resorted and the Current Environment Length is recomputed.
  113.  
  114.      CHANGING AN EXISTING ENVIRONMENT VARIABLE:
  115.  
  116.      The currently highlighted Environment Variable may be changed by press-
  117.      ing  ALT-C.   When this is done,  an edit box is displayed just to  the
  118.      right of the equal sign and the cursor will be positioned at the end of
  119.      the string OR at the right border of the screen if the string is longer
  120.      than the width of the screen.   To scroll the string,  use the right or
  121.      left cursor keys.  To delete characters, either the DELETE or BACKSPACE
  122.      Keys  may be used.   Only overtype mode is supported.  Any edit may  be
  123.      completed  by pressing the UP or DOWN cursor,  HOME or END keys or  RE-
  124.      TURN.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                    CHGENV.EXE
  137.                             A DOS ENVIRONMENT EDITOR
  138.  
  139.                                        BY
  140.                                  PETER A. HYMAN
  141.                                  (609) 799- 2638
  142.  
  143.  
  144.      SAVING THE CHANGES:
  145.  
  146.      After all Environment Changes have been completed,  F10 may be  pressed
  147.      to  save the changes.   Replying 'Y' to the Save Changes?  prompt  will
  148.      cause the modified environment to be copied back into the Master  Envi-
  149.      ronment Location.   This is the copy of the environment which is  given
  150.      to  each process or subprocess.   Any TSRs already loaded have  already
  151.      inherited  their  environments and cannot be affected by  this  change. 
  152.      However,  all new commands,  programs or new invocations of  a  command
  153.      processor will inherit the modified environment.
  154.  
  155.      DISCLAIMER:
  156.  
  157.      Every  effort has been made to test this program and assure its  integ-
  158.      rity.   If it does not work on your system,  please let me know immedi-
  159.      ately.
  160.  
  161.      This program is being placed in the public domain as shareware.  Please
  162.      distribute  it freely to other BBSs or users.   You should include  the 
  163.      files CHGENV.EXE and CHGENV.TXT.    You may not charge a  fee  for  the
  164.      product or resell it in combination with any other product without per-
  165.      mission.
  166.  
  167.      If you like CHGENV.EXE and find it helpful,  please register your  sup-
  168.      port by remitting a $10 registration fee.   Include your name,  address
  169.      and phone to:
  170.  
  171.      PETER A. HYMAN, INC.
  172.      148 Tennyson Drive
  173.      Plainsboro, NJ  08536
  174.  
  175.      Registered  users  will receive updates to the product for  the  coming
  176.      year.
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.